Effects Store User Guide
------------------------------------------------------------------------------

This is a short user guide for Effects Store, to answer some common questions
and help you diagnose some issues that are known to occur under certain
situations.

Q: How do I buy, sell, and use effects?
A: Effects Store 2 is structured very differently from past special effects
	set ups.  In this version, special effects are stored as normal shop items.
	This means you can have several different versions of each effect.  For
	example, you can own ten items that each give a different username color.
	Most of the normal shop functions (like give, trade, and discard) can work
	for each effect item, also.  Buying items works like normal shop items, with
	the exception of some special options on some buying pages.

	Of course, you can still only use one name color at a time, so you have to
	select that somewhere.  It wouldn't be fun to sell five of your six name
	color items only to find you wound up keeping the one you like the least,
	either.  You can select effects to use or sell from your shop inventory.
	Click the Your Inventory link at the bottom of any Shop page; on the
	following page, click the name of any color effect item.

	Now you will see a special page where you can select effect items to use, or
	sell.  You can also remove effects from active use here.  Custom title
	effects work the same way.  Colors and custom titles are defined for each
	item when you purchase the item.

	Using privilege items is a little more complex, because there are many kinds
	of privileges.  Some privilege items (like those for avatars) only need to
	be purchased, after which they are used automatically.  Other privilege
	items will have clickable names, just like the color items.  When you click
	on the name of these items, you will see a special page that allows you to
	use the item.  Aside from the special usage page, these items act just like
	normal items.

Q: Where are all the configuration options that use to be in the Effects Store
	administration panel area?
A: Effects Store 2 is much more integrated with the base Shop admin panel than
	previous versions.  Some basic settings are still under Effects Store
	Configuration, but most shop and item details can be altered through the
	basic Shop forms for Shop Editor and Item Editor.

Q: I don't want to use some of the special effects, like the ability to change
	other people's custom titles.  How can I disable these?
A: Because effects and privileges are now stored as items, you need to make the
	related items unavailable to users.  The best thing to do is to access the
	related item in the Item Editor and select a hidden shop from the drop down
	list.  The Disabled Effects shop is a hidden shop provided for storage of
	items you don't	want to use.

Q: Which items match up to which effects?
A: Here are the default names of the items related to each effect or privilege:
	Effect/Privilege					Item Name
	Username color						Name Color
	Username glow						Name Glow
	Username shadow						Name Shadow
	Rank color							Rank Color
	Rank glow							Rank Glow
	Rank shadow							Rank Shadow
	Custom Title color					Title Color
	Custom Title glow					Title Glow
	Custom Title shadow					Title Shadow
	Post text color						Message Color
	Post background color				Message Background
	Add/Change Custom Title				Title Tag
	Change Username						Name Tag
	Change Others' Custom Title			Title Stamp
	Replace Rank with Title				Title Badge
	Use Avatars							Avatar Ticket
	Use Signatures						Signature Ticket

Q: Can I rename the Effects Store items?
A: You can safely change any information related to the Effects Store
	configuration or items that is displayed in the phpBB/Shop Administration
	Control Panel, except for the Special Link field.  Do not change that field;
	doing so will break the links that allow you to use the items.

Q: Glow and Shadow effects don't work!  Why?
A: The Glow and Shadow effects rely on proprietary features of Microsoft
	Internet Explorer.  This means they cannot function in browsers that do not
	use IE's rendering engine, such as Firefox or Opera.  This is a browser
	issue that cannot be fixed.  As a substitute for the standard Glow and
	Shadow, background colors are displayed in browsers other than IE.

Q: I am using Internet Explorer, or another browser with IE's rendering engine,
	but Glow and Shadow still don't work.  Why?
Q: Glow and Shadow work on some of my forum's templates, but not others.  Why?
A: There is an issue with some forum templates that prevent Glow and Shadow
	effects from functioning.  Please see the contrib/fix_doctype.txt file for
	instructions on overcoming this issue.

Q: When I use both Glow and Shadow effects, only one appears.  Why?
A: Both effects use the same methods of CSS styling.  In other words, one
	overrides the other.  It will usually be Shadow overriding Glow, simply
	because the Shadow effects are added later.

Q: When a user with a long username activates a Glow or Shadow username effect,
	their name no longer wraps to a second line	in Internet Explorer, or another
	browser with IE's rendering engine.  How can I get these names to wrap to
	another line?
A: Don't use Glow or Shadow or with them. :( The Glow/Shadow code requires a
	width setting for the effect to appear.  For a consistent display throughout
	the forum, this is set to 10 pixels with a nowrap attribute to prevent text
	wrapping with a bad appearance in some places.  Really long usernames may
	stretch the author column in threads and forums because of this, but that
	is the price of Glow/Shadow on those names.

Q: Can I tweak the HTML of the effects?
A: Sure.  It is in templates/<whatever>/shop/effects_html.tpl.  Have fun.

Q: Why don't effects appear throughout all parts of the forum?
A: It takes a lot of work to place the effects everywhere, especially when you
	look at modifications that add new areas.  It isn't feasible for one person
	to take on such a task.

Q: The effects overwrite colors added by another modification.  How can I
	resolve this?
A: In Effects Store 2, steps have been taken to minimize this as much as
	possible.  Effects Store will add colors and other effects after other
	modifications and inside the code from other modifications.  If color
	overwriting still occurs, then there is not likely much that can be
	done to make the other modification and Effects Store compatible.

Q: I have some strange user name displays in topics, like one of these:
		MyUsername');">MyUsername
		MyUsername[/b], ')">MyUsername
A: This is the result of a conflict between some Quick Reply modifications and
	modifications that add colors to usernames.  As with the color overwriting
	problem, steps have been taken to prevent this from happening in Effects
	Store 2.  If it still occurs, then again, there is not likely much that can
	be done to make the other modification and Effects Store compatible.

Q: The signature field isn't appearing in my profile editor, even when I have
	the Signature Ticket item.  What can I do?
A: There are a few modifications that place additional template switches in the
	profile editor.  If you see a line, not added by Effects Store, that says
	<!-- BEGIN something --> or <!-- END something --> ("something" is just a
	placeholder, it could say different things there) near the HTML for the
	signature box in profile_add_body.tpl, you probably have one of these
	situations.
	Please visit http://www.phpbbsmith.com/ and post a message on the Support
	Board so I can help you	resolve this issue.  Include a link to your
	profile_add_body.tpl, so I can see the code in it. This matter is usually
	not hard to fix, but the exact nature of the fix depends on the code of your
	file.

Q: I have a question or issue that is not resolved here.  Where do I go for more
	help?
A: My support forum is located at http://www.phpbbsmith.com/.  I also try to
	visit Zarath's support forum and the phpBBHacks.com support forum regularly.

Updated May 2, 2007